Справочник по конфигурации¶

app.roles.slow_log.enable¶

Включить запись в журнал медленных запросов. По умолчанию запись будет включена для запросов через модуль CRUD.

Тип: boolean

Значение по умолчанию: false

app.roles.slow_log.threshold¶

Максимальное время выполнения запроса в секундах. При превышении этого значения запрос считается медленным и записывается в журнал.

Тип: number

Значение по умолчанию: 0.5

app.roles.slow_log.namespaces¶

Задать функции, для которых будет включено логирование медленных запросов.

Тип: table

Значение по умолчанию: {}

app.roles.tracing.enabled¶

Включить трассировку.

Тип: boolean

Значение по умолчанию: false

app.roles.tracing.global_sample_rate¶

Глобальный коэффициент частоты трассировки – трассируется каждый N-й вызов функции. Примеры:

10 – трассируется каждый десятый запрос; 1 – трассируются все запросы; 0 – все запросы не трассируются.

Тип: integer

Значение по умолчанию: 0

app.roles.tracing.sample_rates¶

Коэффициенты частоты трассировки для заданных сегментов (spans). Значение опции – это таблица из пар ключ-значение, где

• ключ – название сегмента;

• значение – частота трассировки для этого сегмента.

Тип: table

Значение по умолчанию: ‘{}’

Пример:

  sample_rates:
    get_user: 1000
    get_token: 10000

app.roles.tracing.base_url¶

URL-адрес сервера трассировки, куда отправляются данные трассировки.

Тип: string

Значение по умолчанию: ‘http://127.0.0.1:9411/api/v2/spans’

app.roles.tracing.api_method¶

HTTP-метод, используемый для отправки данных трассировки на сервер. Возможные значения: POST, GET, PUT.

Тип: string

Значение по умолчанию: ‘POST’

app.roles.tracing.report_interval¶

Интервал в секундах между отправкой на сервер собранных данных о трассировке.

Тип: integer

Значение по умолчанию: 10

app.roles.tracing.spans_limit¶

Максимальное количество сегментов (span) трассировки, которые могут быть сохранены локально на экземпляре Tarantool перед отправкой во внешнюю систему хранения результатов трассировки.

Тип: integer

Значение по умолчанию: 1000

config.storage.status_check_interval¶

Интервал в секундах между проверками состояния сервера в кластере.

Тип: number

Значение по умолчанию: 5

roles.cooler.<name>¶

Название спейса memtx, для которого настраивается архивация. Обязательный параметр.

Тип: string

roles.cooler.<name>.expirationd.<index_name>¶

Название индекса, по которому идет сканирование спейса. На каждый индекс спейса может быть задана только одна задача архивации. Настройка этой опции позволяет избежать лишнего прохода по первичному ключу, если используется другой, более подходящий индекс (например, по last_updated или archived_at):

• если секция expirationd.\<index_name\> присутствует и содержит только вторичные индексы, идет сканирование только по этим индексам. Задача по первичному ключу при этом не запускается;

• если секция expirationd.\<index_name\> пропущена, по умолчанию идет сканирование по первичному ключу;

• если требуется запуск по первичному ключу вместе с другими индексами или настройка параметров, необходимо явно указать секцию expirationd.\<index_name\> с названием первичного ключа в конфигурации (см. пример выше).

Тип: string

roles.cooler.<name>.expirationd.<index_name>.force¶

Если задано значение false, модуль expirationd обрабатывает задачи для всех типов спейсов только на экземпляре, доступном для записи. Он не обрабатывает задачи для нелокальных персистентных спейсов на экземпляре только для чтения. Это означает, что expirationd не будет запускать обработку задачи на реплике для обычных спейсов. Если задано значение true, принудительно включается обработка такой задачи.

Тип: boolean

Значение по умолчанию: false

roles.cooler.<name>.expirationd.<index_name>.force_allow_functional_index¶

Если задано значение false, модуль expirationd возвращает ошибку при итерации по функциональному индексу, поскольку это может привести к сбою. Вы можете пропустить ошибку, установив значение true, например при реализации собственной функции iterate_with.

Тип: boolean

Значение по умолчанию: false

roles.cooler.<name>.expirationd.<index_name>.full_scan_delay¶

Время ожидания между полными сканированиями в секундах. В значении опции допустимо передавать номер FFI, например 1LL или 1ULL.

Тип: number

Значение по умолчанию: 1

roles.cooler.<name>.expirationd.<index_name>.full_scan_time¶

Время обхода спейса в секундах. Используется для расчета пауз между итерациями. Настройка регулирует скорость работы архивации данных. В значении опции допустимо передавать номер FFI, например 1LL или 1ULL.

Тип: number

Значение по умолчанию: 3600

roles.cooler.<name>.expirationd.<index_name>.iterate_with¶

Название функции, возвращающей итератор для обхода спейса. Если опция не указана, используется функция по умолчанию. Функция по умолчанию возвращает такой итератор, какой возвращается в index_object:pairs().

Тип: string

roles.cooler.<name>.expirationd.<index_name>.iteration_delay¶

Максимальное время ожидания между итерациями в секундах. В значении опции допустимо передавать номер FFI, например 1LL или 1ULL.

Тип: number

Значение по умолчанию: 1

roles.cooler.<name>.expirationd.<index_name>.iterator_type¶

Тип итератора для обхода спейса: строка или константа box.index, например, EQилиbox.index.EQ`.

Тип: string или number

Значение по умолчанию: box.index.ALL

roles.cooler.<name>.expirationd.<index_name>.on_full_scan_error¶

Имя функции, которая вызывается после завершения полного сканирования из-за ошибки.

Тип: string

roles.cooler.<name>.expirationd.<index_name>.on_full_scan_success¶

Имя функции, которая вызывается после успешного завершения полной итерации сканирования.

Тип: string

roles.cooler.<name>.expirationd.<index_name>.process_while¶

Имя функции, которая вызывается перед проверкой каждого кортежа. Если функция возвращает false, задача останавливается до следующего полного сканирования. По умолчанию используется функция, которая всегда возвращает true.

Тип: string

roles.cooler.<name>.expirationd.<index_name>.start_key¶

Значение индекса кортежа, с которого начнется итерация. Если тип итератора — EQ, выполняется итерация по кортежам с этим значением индекса. Если параметр пропущен или равен нулю, будут проверены все кортежи.

Значение опции должно соответствовать одному из условий ниже:

• значение имеет тот же тип данных, что и поле (или поля) индекса;

• если в start_key передана функция, она возвращает тот же тип данных, что и поле (или поля) индекса.

Если в start_key передана строка, она интерпретируется как имя функции.

Тип: string или table

roles.cooler.<name>.expirationd.<index_name>.tuples_per_iteration¶

Количество кортежей, которое проверяется за одну итерацию. В значении опции допустимо передавать номер FFI, например 1LL или 1ULL.

Тип: number

Значение по умолчанию: 1024

roles.cooler.<name>.expirationd.<index_name>.vinyl_assumed_space_len¶

Предполагаемый размер спейса vinyl в первой итерации. Размер спейса vinyl невозможно подсчитать точно, поскольку многие операции (например, upsert) выполняются при обращении к данным. Поэтому следует подсчитывать размер кортежей при первом запуске – это позволит определить приблизительный размер спейса. Значение опции vinyl_assumed_space_len – это приблизительный размер спейса для первого запуска. В значении опции допустимо передавать номер FFI, например 1LL или 1ULL.

Смотрите также: roles.cooler.<name>.expirationd.<index_name>.vinyl_assumed_space_len_factor.

Тип: number

Значение по умолчанию: 10⁷

roles.cooler.<name>.expirationd.<index_name>.vinyl_assumed_space_len_factor¶

Коэффициент для пересчёта размера спейса vinyl. Размер спейса vinyl невозможно подсчитать точно, поскольку многие операции (например, upsert) выполняются при обращении к данным. Поэтому следует подсчитывать размер кортежей при первом запуске – это позволит определить приблизительный размер спейса. vinyl_assumed_space_len – это приблизительное количество для первого запуска, а значение опции vinyl_assumed_space_len_factor – для следующего этапа. В значении опции допустимо передавать номер FFI, например 1LL или 1ULL.

Тип: number

Значение по умолчанию: 2

roles.crud-<router_or_storage>.stats¶

Включить сбор метрик модуля CRUD.

По умолчанию сбор метрик отключен, так как их работа снижает производительность:

• на 3-10% – при использовании локального драйвера;

• 5-15% – при использовании драйвера метрик. Этот драйвер используется по умолчанию;

• до 20% – при использовании метрик, которые содержат квантили.

Тип: boolean

Значение по умолчанию: false

roles.crud-<router_or_storage>.stats_driver¶

Задать драйвер для хранения собранных метрик CRUD. Возможные значения:

• local – использовать локальный драйвер;

• metrics– использовать драйвер метрик.

Тип: string

Значение по умолчанию: ‘metrics’

roles.crud-<router_or_storage>.stats_quantiles¶

Включить квантили метрик. Опция crud.stats_quantiles работает только в том случае, если в опции roles.crud-<router_or_storage>.stats_driver задан драйвер метрик (crud.stats_driver = 'metrics').

Тип: boolean

Значение по умолчанию: false

roles.crud-<router_or_storage>.stats_quantile_age_buckets_count¶

Количество сегментов квантилей summary. Увеличение значения сглаживает скользящее окно, но потребляет дополнительную память и CPU. Опция crud.stats_quantile_age_buckets_count работает только в том случае, если в опции roles.crud-<router_or_storage>.stats_driver задан драйвер метрик (crud.stats_driver = 'metrics').

Тип: number

Значение по умолчанию: 2

roles.crud-<router_or_storage>.stats_quantile_max_age_time¶

Время жизни сегмента (bucket) в секундах. Опция crud.stats_quantile_max_age_time работает только в том случае, если в опции roles.crud-<router_or_storage>.stats_driver задан драйвер метрик (crud.stats_driver = 'metrics').

Меньший срок жизни сегмента приводит к меньшему временному окну для квантилей, при этом больше ресурсов CPU используется на ротацию сегментов. Если у вашего приложения низкая частота запросов, увеличьте значение, чтобы уменьшить количество пробелов -nan в значениях квантилей.

Узнать больше про опцию crud.stats_quantile_max_age_time можно в документации Tarantool в разделе Мониторинг.

Тип: number

Значение по умолчанию: 60

roles.crud-<router_or_storage>.stats_quantile_tolerated_error¶

Задать допустимую погрешность квантиля. Опция stats_quantile_tolerated_error работает только в том случае, если в опции roles.crud-<router_or_storage>.stats_driver задан драйвер метрик (crud.stats_driver = 'metrics').

Узнать больше про опцию crud.stats_quantile_tolerated_error можно в документации Tarantool в разделе Мониторинг.

Тип: number

Значение по умолчанию: 0.001

roles.dictionary-<router_or_storage>.batch_size¶

Размер пакета для обмена между узлами в байтах.

Тип: number

Значение по умолчанию: 400

roles.dictionary-<router_or_storage>.worker_sleep_in_second¶

Интервал в секундах между опросами соседнего экземпляра на наличие новых данных.

Тип: number

Значение по умолчанию: 3

roles.dictionary-<router_or_storage>.update_instances_list_period¶

Доступно с версии 2.0.0.

Частота обновления списка узлов в секундах. Модуль хранит список узлов и отслеживает нездоровые узлы. При обнаружении нездорового узла модуль прекращает попытки связаться с ним до следующего обновления списка. Опция также позволяет отслеживать появление новых узлов в кластере.

Тип: number

Значение по умолчанию: 60

roles.dictionary-<router_or_storage>.connect_timeout¶

Доступно с версии 2.0.0.

Время ожидания установки соединения в секундах.

Тип: number

Значение по умолчанию: Неограниченно

roles.expirationd.<name>¶

Название задачи по устареванию данных. Обязательный параметр.

Тип: string

roles_cfg:
  roles.expirationd:
    task_name1:
      space: messages
      options:
        args:
          lifetime_in_seconds: 15
          time_create_field: dt

roles_cfg:
  roles.expirationd:
    messages_expiration:
      space: messages
      is_expired: messages_is_tuple_expired
      is_master_only: true
      options:
        tuples_per_iteration: 100
        iterate_with: messages_iterate_with
        process_expired_tuple: messages_process_expired_tuple
        args:
          seconds: 5

roles.expirationd.<name>.is_expired¶

Название функции, которая получает кортеж и проверяет его срок жизни. Функция возвращает true, если время жизни кортежа истекло. Обязательный параметр.

Тип: function

roles.expirationd.<name>.is_master_only¶

Запустить работу с устаревающими кортежами только на master-узлах.

Тип: boolean

Значение по умолчанию: false

roles.expirationd.<name>.space¶

Название спейса или идентификатор спейса, по которому идет поиск устаревших кортежей. Обязательный параметр.

Тип: string или number

roles.expirationd.<name>.options¶

Дополнительные опции конфигурации.

Тип: table

Значение по умолчанию: {}